home *** CD-ROM | disk | FTP | other *** search
/ Power Tools 1993 October - Disc 2 / Power Tools (Disc 2)(October 1993)(HP).iso / hotlines / cshhl / pdsoft / 3.txt < prev    next >
Text File  |  1993-05-10  |  13KB  |  382 lines
  1. >
  2. ***********************************************************************
  3. > *                                                                   *
  4. > *                 The introductory guide                            *
  5. > *                                                                   *
  6. > *********************************************************************
  7. >
  8. >
  9. >
  10. >
  11. >
  12. >
  13. >
  14. >  Accessing the HP-UX archive at The University of Liverpool
  15. >
  16. >                         Janet Little
  17. >                        Richard Lloyd
  18. >
  19. >                Department of Computer Science
  20. >                   University of Liverpool
  21. >                         P.O. Box 147
  22. >                          Liverpool
  23. >                           L69 3BX
  24. >                  e-mail: ftp@csc.liv.ac.uk
  25. >
  26. >                       Wed 19 Aug 1992
  27. >
  28. >
  29. >
  30. > The HP-UX archive at The University of Liverpool  Department
  31. > of  Computer  Science  contains public domain software which
  32. > has been successfully ported to the  Hewlett-Packard  series
  33. > 700;  much  of  the software also runs under the 300/400/800
  34. > series.  This document is intended as an introductory  guide
  35. > to  obtaining  and  installing software from the archive for
  36. > users unfamiliar with accessing public domain archive sites.
  37. >
  38. >
  39. >  1. Making contact with the site
  40. >
  41. > A remote archive site can be accessed  using  anonymous  FTP
  42. > (File  Transfer  Program)  on the Internet network. FTP is a
  43. > software package which enables the connection  of  a  client
  44. > host  machine  to a remote host and facilitates the transfer
  45. > of files between them.  Many archive sites can  be  accessed
  46. > in this way; the Liverpool archive is just one such site. To
  47. > use FTP it is necessary to know the address  of  the  remote
  48. > site  which  can  then  be supplied on the FTP command line.
  49. > The following command will connect to the Liverpool archive:
  50. >
  51. >                $ ftp  ftp.csc.liv.ac.uk
  52. >
  53. > This should result in the appearance of a login  prompt.  In
  54. > order  to  use the archive you are required to log on to the
  55. > archive machine under the username `anonymous'.  An  attempt
  56. > to  do  this will result in a password request. The password
  57. > you supply should take the form of your  e-mail  address  on
  58. > your  own  machine,  i.e.   <username>@<address>. An example
  59. > login would be as follows:
  60. >
  61. >                Name: anonymous
  62. >                Password: joe@gan.csc.liv.ac.uk
  63. >
  64. > You should now be successfully connected  to  the  Liverpool
  65. > archive  machine  and the FTP prompt will appear. The set of
  66. > commands supported by FTP can be viewed by using the command
  67. > `help':
  68. >
  69. >
  70. >
  71. >                       August 19, 1992
  72. >
  73. >
  74. >
  75. >
  76. >
  77. >                            - 2 -
  78. >
  79. >
  80. >                ftp> help
  81. >
  82. > (To find the purpose of  any  one  command,  again  use  the
  83. > command `help' this time followed by the command name.)
  84. >
  85. > To facilitate file transfer from the archive some sites  may
  86. > require binary transfer mode to be switched on as follows:
  87. >
  88. >                ftp> binary
  89. >
  90. > For most sites (eg UNIX sites) this will not  be  necessary;
  91. > if  unsure  it is advisable to always switch on binary mode.
  92. > It may also be helpful to switch on hashing mode which  will
  93. > cause  a  hash  symbol  to  appear  every time 1k of data is
  94. > transferred. This  is  useful  when  long  files  are  being
  95. > copied.
  96. >
  97. >                ftp> hash
  98. >
  99. > Access to the archive is given  at  the  top  level  of  its
  100. > directory  structure. In order to browse through the archive
  101. > and  locate  packages  it  will  be  helpful  to  understand
  102. > something of the way in which the archive is organised.
  103. >
  104. >
  105. >  2. Organisation of the archive
  106. >
  107. > The HP-UX  archive  is  organised  as  a  tree-structure  of
  108. > directories    housing    either    software   packages   or
  109. > documentation. The main directory structure is as follows:
  110. >
  111. >
  112. >      /hpux       This holds the HP-UX software. It  is  itself
  113. >                  organised  into  a  number  of subdirectories
  114. >                  each of which house a set  of  related  pack-
  115. >                  ages.
  116. >      /TroffDoc   This directory holds up-to-date copies of all
  117. >                  documents  relating  to the archive, in troff
  118. >                  format. In order to facilitate  the  printing
  119. >                  of  these documents you will need either AT&T
  120. >                  troff or Gnu groff.
  121. >      /TextDoc    This directory holds plain text  versions  of
  122. >                  the  documents held in /TroffDoc suitable for
  123. >                  users who do not have troff facilities.
  124. >
  125. >
  126. > Each directory (including the top level)  contains  its  own
  127. > README file which provides any necessary general information
  128. > and a brief description of the  directory  contents.   Apart
  129. > from README files, most files held in the archive are stored
  130. > in compressed form having a file type  of  .Z.  The  set  of
  131. > source  files which constitute a software package are stored
  132. > within /hpux in a single compressed tar archive file with  a
  133. > file type of tar.Z. Each package includes a README.LUCS file
  134. >
  135. >
  136. >
  137. >                       August 19, 1992
  138. >
  139. >
  140. >
  141. >
  142. >
  143. >                            - 3 -
  144. >
  145. >
  146. > provided  by  the  Liverpool  site  when  the  package   was
  147. > archived.   The   file   /Conventions  contains  information
  148. > describing the conventions used at Liverpool  for  archiving
  149. > and  compiling  the software. This file should be read prior
  150. > to obtaining and installing software.
  151. >
  152. > In order to copy a file it is necessary  only  to  know  the
  153. > directory in which it is housed.  The commands `ls' and `cd'
  154. > can be used from within FTP to list and  change  directories
  155. > respectively.   In  this  way  a  user can browse around the
  156. > archive. Files which summarise the  contents  of  the  /hpux
  157. > directory  are  available  from  the  /TroffDoc and /TextDoc
  158. > directories. The file /TroffDoc/Catalogue.all.troff.Z  holds
  159. > a  complete list of all archived software with descriptions.
  160. > For users who do not possess troff a plain text  version  of
  161. > the  catalogue is available in /TextDoc/Catalogue.all.txt.Z.
  162. > The file /TroffDoc/Catalogue.month.troff.Z contains  a  sum-
  163. > mary  of  packages  archived within the last month - a plain
  164. > text version is available in /TextDoc/Catalogue.month.txt.Z.
  165. > Catalogue  files are synthesised automatically each day from
  166. > the README.LUCS files  and  therefore  reflect  the  current
  167. > state of the archive. Alternatively, the file /ls-lR.Z holds
  168. > a recursive directory listing of the  archive.  FTP  can  be
  169. > used to fetch any of these files.
  170. >
  171. >
  172. >  3. Copying files
  173. >
  174. > Any file can be copied from the archive using the  FTP  com-
  175. > mand  `get'.  Once  copied, compressed files will need to be
  176. > uncompressed in one of two ways depending  upon  whether  or
  177. > not  the file is a software package and thus compressed as a
  178. > tar file. Furthermore, where an X11 package  is  copied  the
  179. > way in which it should be installed may require explanation.
  180. > Thus, to illustrate these differences, the  following  files
  181. > are  copied  and  subsequently  uncompressed/compiled in the
  182. > examples below: the archive catalogue, in plain  text  form,
  183. > held within the subdirectory /TextDoc; the spreadsheet pack-
  184. > age `sc', stored in the subdirectory /hpux/Users;  the  xar-
  185. > chie  package  from  the  subdirectory /hpux/X11. The latter
  186. > package is an X windows package which provides a  convenient
  187. > method  of accessing archive sites and retrieving data; xar-
  188. > chie is described in more detail in section 6.  Note that in
  189. > order  to successfully install an X11 package both imake and
  190. > Xaw include  files  must  be  present  on  your  system;  if
  191. > required  these  are  available  from  the archive directory
  192. > /hpux/X11.
  193. >
  194. > Firstly, to obtain the catalogue change into  the  directory
  195. > /TextDoc:
  196. >
  197. >                        ftp> cd TextDoc
  198. >
  199. > The desired file, in this case the full catalogue,  can  now
  200. >
  201. >
  202. >
  203. >                       August 19, 1992
  204. >
  205. >
  206. >
  207. >
  208. >
  209. >                            - 4 -
  210. >
  211. >
  212. > be fetched using the `get' command:
  213. >
  214. >                        ftp> get Catalogue.all.txt.Z
  215. >
  216. > The file will be transferred; as hashing has been turned  on
  217. > the progress of the transfer will be evident. On completion,
  218. > the FTP prompt will  reappear.  To  obtain  the  spreadsheet
  219. > package `sc':
  220. >
  221. >                        ftp> cd ../hpux/Users
  222. >                        ftp> get sc-6.21.tar.Z
  223. >
  224. > and similarly:
  225. >                        ftp> cd ../X11
  226. >                        ftp> get xarchie-1.3.tar.Z
  227. >
  228. > Any number of files can be transferred in the same way  dur-
  229. > ing an FTP session.
  230. >
  231. >
  232. >  4. Ending the FTP session
  233. >
  234. > To logout from the archive site once all transfers have been
  235. > completed, simply quit from FTP:
  236. >
  237. >                        ftp> quit
  238. >
  239. >
  240. >  5. Uncompressing files and installing software
  241. >
  242. > As mentioned above, once any compressed files have been suc-
  243. > cessfully  obtained  from  the archive the way in which they
  244. > are uncompressed depends upon whether they are documents (.Z
  245. > files)   from  the  /TroffDoc  or  /TextDoc  directories  or
  246. > software (tar.Z files) from /hpux.
  247. >
  248. >
  249. >  5.1. Documents:
  250. >
  251. > Documents can be unpacked using  the  `uncompress'  command.
  252. > So:
  253. >
  254. >                  $ uncompress Catalogue.all.txt.Z
  255. >
  256. > will uncompress  the  catalogue,  generating  a  file  named
  257. > Catalogue.all.txt  in your directory which may now be viewed
  258. > or printed.
  259. >
  260. >
  261. >
  262. >
  263. >  5.2. Software packages (excluding X11):
  264. >
  265. > To uncompress tar files the command `zcat' should  be  used.
  266. >
  267. >
  268. >
  269. >                       August 19, 1992
  270. >
  271. >
  272. >
  273. >
  274. >
  275. >                            - 5 -
  276. >
  277. >
  278. > Thus for the spreadsheet:
  279. >
  280. >                    $ zcat sc-6.21.tar.Z | tar xvf -
  281. >
  282. > This will create a new directory, the name of which  is  the
  283. > name  of the package. To access the files within the package
  284. > change into that directory and compile the files:
  285. >
  286. >                    $ cd sc-6.21
  287. >                    $ make
  288. >
  289. > It should now be possible to use the package:
  290. >
  291. >                    $ ./sc
  292. >
  293. >
  294. >  5.3. X11 packages:
  295. >
  296. > Remember that in order to successfully install X11  packages
  297. > you  must have both imake and Xaw include files installed on
  298. > your system. The X11 package first needs to be  uncompressed
  299. > as above:
  300. >
  301. >                    $ zcat xarchie-1.3.tar.Z | tar xvf -
  302. >
  303. > This will again produce a directory containing the  packaged
  304. > files.
  305. >
  306. >                    $ cd xarchie-1.3
  307. >
  308. > The following command will run imake in order to generate  a
  309. > top level Makefile:
  310. >
  311. >                    $ xmkmf
  312. >
  313. > If the package includes  a  directory  tree  which  contains
  314. > other Imakefiles then the following should be performed:
  315. >
  316. >                    $ make Makefiles
  317. >
  318. > It may be necessary to resolve any makefile dependencies:
  319. >
  320. >                    $ make depend
  321. >
  322. > Finally:
  323. >
  324. >                    $ make
  325. >
  326. > The binary can now be run:
  327. >
  328. >                    $ ./xarchie
  329. >
  330. > Once the program runs satisfactorily the binaries,  applica-
  331. > tion  defaults  and  library  files  can  be copied into the
  332. >
  333. >
  334. >
  335. >                       August 19, 1992
  336. >
  337. >
  338. >
  339. >
  340. >
  341. >                            - 6 -
  342. >
  343. >
  344. > appropriate system directories (as defined by imake) and the
  345. > manual pages updated. This can be done using the single com-
  346. > mand:
  347. >
  348. >                    $ make install install.man
  349. >
  350. >
  351. >
  352. >  6. Accessing other archive sites
  353. >
  354. > Using anonymous FTP to access  archive  sites  requires  the
  355. > address  of  the  site  to  be known.  The xarchie software,
  356. > retrieved in the  example  above,  provides  an  alternative
  357. > method  of  accessing  anonymous  ftp  sites  which does not
  358. > require site addresses to be known by the user  in  advance.
  359. > Xarchie  provides an X windows interface through which it is
  360. > possible to select from a large set  of  registered  archive
  361. > sites. The interface allows the user to specify search terms
  362. > in order to locate sites containing relevant  material;  the
  363. > contents  of  archive directories can be displayed and pack-
  364. > ages selected for retrieval.  The Liverpool HP-UX archive is
  365. > currently  being  registered  with  xarchie servers and thus
  366. > will shortly be accessible via the xarchie interface.
  367. >
  368. >
  369. >  7. Submitting software to the HP-UX archive
  370. >
  371. > The porting and archive centre at The University  of  Liver-
  372. > pool  is  very interested to hear from users who have public
  373. > domain software which runs under  HP-UX  and  which  is  not
  374. > currently  available  from the Liverpool archive.  Please e-
  375. > mail the following with a view to making your software  more
  376. > widely available via the archive:
  377. >
  378. >                      ftp@csc.liv.ac.uk
  379. >
  380.  
  381. 
  382.